Skip to content

Add T7 storage credit docs#503

Open
max-digi wants to merge 9 commits into
mainfrom
max/t7-storage-credit-docs
Open

Add T7 storage credit docs#503
max-digi wants to merge 9 commits into
mainfrom
max/t7-storage-credit-docs

Conversation

@max-digi

@max-digi max-digi commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Expand the T7 network upgrade page with the planned timeline, partner impact, feature scope, and implementation references.
  • Add Storage Savings to Benefit Your Users as an interactive storage-savings page for user-attributed DEX savings.
  • Add payer-scoped MPP payment-channel savings to the T7 scope, with supporting callouts in the agentic payments and pay-as-you-go docs.
  • Add review-driven updates: clearer same-contract storage-credit wording, highlighted gas saved DEX benchmark rows, a dynamic base fee savings table, and updated related links/sidebar labels.

Implementation PRs and benchmark sources

  • PR 4016 / TIP-1060: contract storage credits.
  • PR 4082 / TIP-1064: StablecoinDEX order storage credits and per-maker allocation.
  • PR 5903: merged StablecoinDEX lifecycle benchmark values used in the tables and explorer.
  • PR 5935 / TIP-1066: payer-scoped TIP-20 channel storage credits for MPP payment channels.
  • PR 5153 / PR 5257: dynamic base fee implementation and fee-range details.
  • PR 5380 / PR 5488: Tempo Token Rewards deprecation and rollout.
  • PR 5305: open TIP-1064 implementation PR to recheck before replacing the current DEX benchmark values with final numbers.

Validation

  • Verified PR 4016 is TIP-1060, PR 4082 is TIP-1064, PR 5153/5257 are TIP-1067, PR 5935 is merged TIP-1066 channel storage credits, and PR 5305 is still open via GitHub.
  • pnpm run check:types
  • pnpm run build
    • Passes with existing dependency warnings about @wagmi/core importing wallet from viem.
    • Static generation may print the existing GitHub changelog fetch warning if api.github.com is blocked, then completes successfully.
  • Local static output checked for /protocol/upgrades/t7/, /guide/t7-storage-credits/, /guide/machine-payments/, and /guide/machine-payments/pay-as-you-go/.
    • Confirmed the T7 page includes payer-scoped payment-channel savings.
    • Confirmed the MPP pay-as-you-go docs include the T7 payment-channel savings callout.
    • Confirmed the storage savings page title renders as Storage Savings to Benefit Your Users.
    • Confirmed the dynamic base fee savings table and DEX gas saved rows render.

Follow-up

  • Add TIP-1066 payment-channel benchmark tables after final benchmark values are reviewed.

@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment Jul 1, 2026 2:16pm

Request Review

@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from 07fc07b to ff4bfc3 Compare June 16, 2026 16:10
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch 2 times, most recently from 10c518f to 0b51b09 Compare June 16, 2026 16:48
@max-digi max-digi marked this pull request as draft June 17, 2026 13:28
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from 0b51b09 to eaa1d7f Compare June 17, 2026 13:35
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch 2 times, most recently from eaa1d7f to c696346 Compare June 17, 2026 14:00
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from c696346 to e6e785b Compare June 17, 2026 14:14
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from e6e785b to 4a07eb1 Compare June 17, 2026 14:22
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from 4a07eb1 to c8d6e50 Compare June 17, 2026 15:12
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from c8d6e50 to 2a49c1a Compare June 17, 2026 16:17
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from 2a49c1a to 48dac2e Compare June 17, 2026 16:34
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from 48dac2e to adbbd81 Compare June 17, 2026 17:08
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from adbbd81 to d536b85 Compare June 17, 2026 17:22
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from d536b85 to f5aba70 Compare June 17, 2026 17:29

@legion2002 legion2002 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should highlight the cost savings of 1067 somewhere with a table. Old transactions could get upto 20x cheaper in dollar terms.

Comment thread src/pages/docs/guide/t7-storage-credits.mdx Outdated
Comment thread src/pages/guide/t7-storage-credits.mdx Outdated
Comment thread src/pages/guide/t7-storage-credits.mdx Outdated
Comment thread src/pages/guide/t7-storage-credits.mdx Outdated
@max-digi max-digi force-pushed the max/t7-storage-credit-docs branch from f5aba70 to 697f7e4 Compare June 18, 2026 13:29
@max-digi max-digi marked this pull request as ready for review June 29, 2026 14:09
Comment thread src/pages/docs/guide/t7-storage-credits.mdx Outdated
Comment thread src/pages/docs/guide/t7-storage-credits.mdx Outdated
* docs: improve storage credits explanation

* fix: typo
# Conflicts:
#	src/pages/docs/guide/machine-payments/pay-as-you-go.mdx
#	src/pages/docs/guide/stablecoin-dex/providing-liquidity.mdx
:::

:::info[T7 payment-channel savings]
The [T7 network upgrade](/docs/protocol/upgrades/t7) adds payer-scoped storage credits for MPP payment channels. When a payer closes or withdraws a finished channel, the reserve can record a channel storage credit for that payer. If the same payer opens another channel later, that payer can reuse the credit. Other payers cannot spend it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The [T7 network upgrade](/docs/protocol/upgrades/t7) adds payer-scoped storage credits for MPP payment channels. When a payer closes or withdraws a finished channel, the reserve can record a channel storage credit for that payer. If the same payer opens another channel later, that payer can reuse the credit. Other payers cannot spend it.
The [T7 network upgrade](/docs/protocol/upgrades/t7) adds payer-scoped storage credits for MPP payment channels. When a payer closes or withdraws a finished channel, the reserve records a channel storage credit for that payer. If the same payer opens another channel later, that payer reuses the credit. Other payers cannot spend it.


In `Refund` mode, storage creations pay upfront. At the end of the transaction, the protocol matches eligible creations with available credits for the same contract, consumes those credits, and applies the gas refund.

| Action | `Refund` mode behavior |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i don't feel like this table helps?


## Storage creation benchmark

The [v1.10.1 release benchmark](https://github.com/tempoxyz/tempo/releases/tag/v1.10.1) shows why this primitive matters. In T6, the TIP-1000 storage creation component cost `250,000` gas. In T7, that component is split into a `5,000` gas residual cost plus a `245,000` gas creditable portion that one storage credit can offset.

@malleshpai malleshpai Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The [v1.10.1 release benchmark](https://github.com/tempoxyz/tempo/releases/tag/v1.10.1) shows why this primitive matters. In T6, the TIP-1000 storage creation component cost `250,000` gas. In T7, that component is split into a `5,000` gas residual cost plus a `245,000` gas creditable portion that one storage credit can offset.
The [v1.10.1 release benchmark](https://github.com/tempoxyz/tempo/releases/tag/v1.10.1) shows why this primitive matters. Before T7, the storage creation component cost `250,000` gas due to TIP-1000. In T7, that component is split into a `5,000` gas residual cost plus a `245,000` gas creditable portion that one storage credit can offset.


That may be fine for some products. For the StablecoinDEX, the intended behavior is different: if Alice's order lifecycle created the reusable storage benefit, Alice should be able to use that benefit when she places a later order.

Use user-level accounting when all of these are true:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm a little confused by this. It seems to suggest that there's just some user-level accounting toggle that you can use, but I don't think that's the case.

Tempo uses a fixed base fee (rather than a variable base fee as in EIP-1559), set so that a TIP-20 transfer costs less than $0.001. All fees accrue to the validator who proposes the block.
Tempo currently uses a fixed base fee (rather than a variable base fee as in EIP-1559), set so that a TIP-20 transfer costs less than $0.001. All fees accrue to the validator who proposes the block.

:::info[Dynamic base fee]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to point out here that dynamic base fees are being introduced in T7?

# T7 Network Upgrade

T7 gives partners a clearer fee model for high-volume payment and exchange flows. It adds storage credits for reusable DEX order and TIP-20 channel state, makes the base fee move down when network usage is below the target threshold, and deprecates new TIP-20 rewards.
T7 makes repeated onchain workflows cheaper and gives partners a clearer fee story for payment and exchange flows. It adds storage savings for DEX order state and TIP-20 payment-channel state, lets the base fee move down when network usage is low, and deprecates new TIP-20 rewards activity.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
T7 makes repeated onchain workflows cheaper and gives partners a clearer fee story for payment and exchange flows. It adds storage savings for DEX order state and TIP-20 payment-channel state, lets the base fee move down when network usage is low, and deprecates new TIP-20 rewards activity.
T7 makes repeated onchain workflows cheaper . It adds storage savings for DEX order state and TIP-20 payment-channel state, lets the base fee move down when network usage is low, and deprecates new TIP-20 rewards activity.

T7 gives partners a clearer fee model for high-volume payment and exchange flows. It adds storage credits for reusable DEX order and TIP-20 channel state, makes the base fee move down when network usage is below the target threshold, and deprecates new TIP-20 rewards.
T7 makes repeated onchain workflows cheaper and gives partners a clearer fee story for payment and exchange flows. It adds storage savings for DEX order state and TIP-20 payment-channel state, lets the base fee move down when network usage is low, and deprecates new TIP-20 rewards activity.

For partners, the headline is simple: apps with repeat contract workflows can pass meaningful gas savings to returning users, MPP sessions can reuse channel-state savings for the same payer, and all users can benefit from lower base fees during quieter network periods.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For partners, the headline is simple: apps with repeat contract workflows can pass meaningful gas savings to returning users, MPP sessions can reuse channel-state savings for the same payer, and all users can benefit from lower base fees during quieter network periods.
Apps with repeat contract workflows can pass meaningful gas savings to returning users, MPP sessions can reuse channel-state savings for the same payer, and all users can benefit from lower base fees during quieter network periods.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants